--------------------------------------------------- This is a plain text version of the readme.wri file --------------------------------------------------- Getting Started with y-IP-ee PPP/SLIP Version 1.10 1. Introduction ================ With just a single IP address (fixed or dynamic) and an analog dial-up PPP or SLIP connection you can give your entire LAN full Internet access. Your LAN can be as small as a PC connected to a Mac, Amiga, PC etc. via a null-modem cable/ethernet, or it can be as big as you like. However, please remember that your bandwidth is fixed by the speed of your modem`s connection, so do not expect to have ten machines operating at 28kbps simutaneously. This isn`t physically possible! yIPee is not a high level multi-proxy server system which tend to eat up TCP/IP resources, yIPee is a low level `IP masquerading` solution. Also, since yIPee is not a proxy based system this means that there are no restrictions on the number of different TCP services which you can access. This is a working demo version of yIPee, so you can try it out for yourself. The demo version restricts you to a limit of 15 minutes on-line per connection. System requirments are that your gateway machine (i.e. the one that will be atattched to the Internet) must be an IBM PC or compatible running Win3.x, Windows`95 or NT, and Core Systems TCP/IP v2.1. (If you do not yet have this TCP/IP stack then you can download it from various ftp sites around the Internet. e.g.) ftp://ftp.tku.edu.tw/pc/winsock/Socket/inetv21.zip ftp://ftp.uni-rostock.de/Winsock/Misc_Utils/Dialers/inetv21.zip ftp://ftp.csusm.edu/pub/winworld/winsock/inetv21.zip 2. Installation =============== Before installing yIPee make sure that you have installed Core Internet- Connect (TM) correctly on your gateway machine, and that the rest of your LAN is responding to this machine. Also set up a serial interface on your gateway machine and connect to your Internet Service Provider, to make sure that your `gateway` is working ok as a single host machine. Please use the Serial Interface called "serial_0" (you can see this beside the Next/Prev buttons in the Core configuration program) to set the preferences for your gateway machine`s connection to your Internet Service Provider. 2.1 Configuration of Fake IP Addresses and Nameservers. ======================================================= Your non-gateway machines will all have "fake" IP addresses, and your gateway machine will also have a "fake" address. (It will also have a real one too!!) You can make these addresses whatever you like with one proviso: The netid byte must be the same for all interfaces across your LAN and the value of this byte must be the same as the netid byte allocated to you by your Internet Service Provider. e.g. If your ISP allocates you an IP of 193.80.142.34, then all interfaces across you LAN should have IP addresses with a netid byte is 193. (Even for those people with dynamically allocated IP addresses the netid byte should remain constant.) Machine A Machine B Machine C 193.0.0.1--null modem--193.0.0.2 (gateway) 193.0.0.3--ethernet--193.0.0.4 193.80.142.34----Internet (A 3 machine LAN maye something like this) You must now also change the nameserver configuration on your non-gateway machines. The nameserver address for these should be set to the fake fixed IP address of your gateway machine. e.g. Using the diagram above, the nameserver option on machines A and B should be set to the address 193.0.0.4 NB The nameserver option on your gateway machine should not be changed and should point to the Domain Name Server of your Internet Service Provider. NB If the connection between machines B and C (gateway) was a null-modem link, then you must use the same link-layer protocol as you are using for the connection between your gateway and your ISP. i.e. do not mix PPP and SLIP on the gateway machine. (However, if the connection between A and B was a null-modem link, then you could use either SLIP or PPP as the link-layer protocol) Providing it is physically possible we would always recommend, for performance reasons, that you should use ethernet instead of null-modem for your local LAN. Also, for similar reasons, if you have the choice between SLIP and PPP for your dialup connection, we would recommend that you choose SLIP as the preferred link-layer protocol since there is less overhead involved with SLIP as opposed to PPP. 2.2 Where to put the files! =========================== Very simple... PPP_YIP.DLL, SLIP_YIP.DLL & HOOK_YIP.DLL must all be copied to your ..\WINDOWS directory. i.e. if you are using SLIP, you must still copy ppp_yip.dll to your windows directory and vice versa. CORE.INI which is part of the Core TCP/IP distribution, must also be moved to your ..\WINDOWS directory. Please make sure to move it and not copy it to your windows directory. ie do not leave a copy of it in the COREWSDS directory. YIPEE.EXE, you can place this file wherever you want. 2.3 Checking the Configuration of your Gateway ============================================== Finally, you should run the program CHK_YIP.EXE This program will examine CORE.INI file and make any changes to it which are critical to the operation of YIPEE. 3. Starting up yIPee ==================== yIPee should not be started until you have dialled up and logged on to your Internet Service Provider. yIPee can then be launched by double clicking on the YIPEE.EXE program. You can do this from within the File Manager, or you can add this program to the Core Internet-Connect window by selecting "New..." from the file menu in Program Manager. This paragraph applies only to those who have dynamically allocated IP addresses. There is currently no way in winsock to determine dynamically allocated IP addresses. Therefore, if you are on a dynamic connection, you will have to pass your IP address to yIPee by typing it into an edit-text requester which will appear after you have launched yipee.exe. You can easily obtain the value of your dynamically allocated IP address from the Core Winsock Monitor window. Select the menu item "Interface Statistics" from the "Stats" menu. If you select this menu item too early, ie before the stack has fully configured itself then the address might still read as 0.0.0.0 The solution is of course just to wait a second or two and then select the menu item again, and you will see the change to 193.80.142.34 or whatever IP address has been allocated to you. If you quit out of yIPee whilst still on-line, the gateway machine will still continue to function normally, but the remainder of your LAN will now in effect be off the Internet. And of course you should quit out of yIPee after you have disconnected from the Internet. (Warning: in the evaluation version, you cannot simply run yipee.exe again to obtain a further 15 minutes, Core TCP/IP must be quit out of, ie expunged from memory, then re-loaded to obtain a further 15 minute allocation.) 4. yIPee in Action ================== yIPee deals specifically with the TCP protocol. This means that you can access any TCP based services from all machines on your LAN. Please note that a peculiarity of FTP is that data connections can be initiated by the server you have contacted. This poses potential problems for yIPee. The solution to this problem is that you must set your FTP client into PASV mode. This ensures all socket connections are initiated by your client. Check the documentation of your FTP client for setting PASV mode. The above is not a problem for your gateway machine, FTP will work for it whether in PASV mode or not. yIPee does not respond to ICMP and UDP packets generated by your LAN, packets of these types will be ignored. Fortunately, this is not a problem, since 99% of applications make use of the TCP protocol. Client applications that will not work with yIPee are Ping, NFS (using UDP), Traceroute. NFS using TCP will work. Also, for the same reason as FTP above, no server daemons can be run on your LAN machines. Again, as above, these limitations do not apply to your gateway machine. It will be able to respond to ICMP and UDP packets, and you will be able to run server daemons on it without any problems. The aforementioned ICMP and UDP limitations are of course in the context of your LAN`s connectivity with the Internet. That is to say, ICMP, UDP and server daemons will work on any of your LAN machines but only across your `local cable`. And of course as has been stressed before none of these limitations apply to the gateway machine itself. There is of course the obligatory exception. UDP clients (such as nslookup, askhost etc.) which acccess the DNS will work on all machines on your LAN. 5. Miscellaneous ================ Providing you have WSOCK32.DLL, then 32-bit Windows client applications will work fine with Core TCP/IP since this dll has a "thunking" layer built into to it to communicate with WINSOCK.DLL. (see Updates and Upgrades for details of a full 32-bit version of yIPee) Bug reports are welcomed. If you encounter what you consider to be a bug, please submit a detailed description of the problem to: donc@rmplc.co.uk 6. How to Order Full Version ============================ By Cash: You can send cash to the value of £26 UK sterling or $39 US dollars to the address given below. Please include your e-mail address. By Cheque: You can send a cheque made out to the amount of £26 UK Sterling. This cheque must be drawable on a UK bank and should be sent to the address given below. Please make the cheque payable to D.Cameron and remember to include your e-mail address. By Eurocheque: You can send a eurocheque made out to the amount of £26 UK Sterling to the address given below. Please make the cheque payable to D.Cameron and remember to include your e-mail address. By NetCash(TM): You can send a NetCash(TM) coupon to the value of $39 US dollars to the e-mail address below. Please send your coupon encrypted using our PGP public key file given below. (If your cyber-wallet contains no NetCash(TM), then you can view their homepage at the following URL, http://www.teleport.com/~netcash) ___________________________________________________________________________ ______________________________ContactDetails________________________________ Snailmail: T-SOFT, PO Box 7971, Ayr KA6 6QD United Kingdom E-mail: donc@rmplc.co.uk WWW: http://www.rmplc.co.uk/eduweb/sites/donc ______________________________________________________________________ -----BEGIN PGP PUBLIC KEY BLOCK----- Version: 2.6.2i mQCNAzGYG7sAAAEEANcGV7RVmr21aeh27wPdvVDV8nmQrRWyinPqkpyfRRGC4YKi PY7mF+nAc4gKVa4oUEs0bZR0fe2UdJkrOP2wLpaMfPtZrO++/reNu7s10QjG3dG8 8IZUSX9t4l+C9i5km5PEGnam3Omz/ljM4cPsBSiRjAeCECDAWfrT2vmbxWD1AAUR tCFEb25hbGQgQ2FtZXJvbiA8ZG9uY0BybXBsYy5jby51az4= =ppab -----END PGP PUBLIC KEY BLOCK----- ______________________________________________________________ 7. Updates and Upgrades ======================= Once you have purchased a copy of the full working version of yIPee, this will entitle you to obtain all future updates and upgrades free of charge. There already is an update available for ethernet users. Future full versions will include: a) a 32-bit PPP version b) a 32-bit SLIP version c) a version supporting ISDN 8. Licence Agreement & Copyright ================================ PLEASE READ THE FOLLOWING LICENSE AGREEMENT CAREFULLY BEFORE INSTALLING AND/OR USING THE SOFTWARE. If you do not agree to this license, discontinue use of the software. 1. GRANT OF LICENSE: T-SOFT grants to you the right to use one copy of the enclosed yIPee software package ("The SOFTWARE") on a single terminal connected to a single computer (i.e. with a single CPU). You may not use the SOFTWARE on more than one computer or computer terminal at the same time. 2. COPYRIGHT: The SOFTWARE is owned by T-SOFT and is protected by United Kingdom copyright laws and international treaty provisions. Therefore, you must treat the SOFTWARE like any other copyrighted material except that you may either (a) make one copy of the SOFTWARE solely for backup or archival purpose, or (b) transfer the SOFTWARE to a single hard disk provided you keep the original solely for backup or archival purposes. You may not copy the written materials accompanying the software. 3. OTHER RESTRICTIONS: This License permits you to use the SOFTWARE for your internal use provided that (a) the SOFTWARE is not modified in any way and (b) you maintain the copyright notice on all copies of the SOFTWARE. You may not rent, lease or otherwise transfer the SOFTWARE. You may not reverse engineer, decompile, or disassemble the SOFTWARE. T-SOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. NEITHER T-SOFT NOR ITS SUPPLIERS SHALL BE LIABLE FOR ANY DAMAGES WHATSOEVER, INCLUDING DIRECT, INDIRECT, CONSEQUENTIAL, INCIDENTAL, LOST PROFITS OR INFORMATION, BUSINESS INTERRUPTION, OR OTHER PECUNIARY LOSS, EVEN IF T-SOFT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. *** Now Go Enjoy ! ***